home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 009a / autochop.zip / AUTOCHOP.DOC next >
Text File  |  1991-10-08  |  8KB  |  165 lines
  1.                           AUTOCHOP - User's Guide
  2.  
  3. AUTOCHOP allows very large files to  be  split across floppy disks and then
  4. later rejoined to re-create the original file.   The intended  use  is  for
  5. large  ZIP  files,   but  any  file type can be successfully processed with
  6. AUTOCHOP.   Several command line options permit easy, intuitive use.  There
  7. is no defined limit to the file sizes that can be handled by AUTOCHOP.
  8.  
  9. AUTOCHOP is copyright (c) 1991 by Randy Langer and MicroSphere  Technology,
  10. Inc.    All  right reserved.   The copyright owner grants license to freely
  11. distribute the ORIGINAL, unaltered .ZIP file to anyone, provided that:
  12.  
  13.    1)  No charge is made,  other than a reasonable disk duplication fee  and
  14.        reasonable postage/handling charges.
  15.        
  16.    2)  No modifications are made to any of the files;  they are distributed
  17.        in their original form.
  18.        
  19. This program is shareware.   You are  granted a license to try this program
  20. out for a period of thirty days.   If you  decide  to  continue  using  the
  21. program after that period,  you are required to register it.   Regsitration
  22. is  $5.00,  payable in US funds.   Registered users will be notified if and
  23. when updates to this program are available,  and where such updates can  be
  24. obtained  from.   See the accompaning file LICENSE.DOC for the registration
  25. form.
  26.  
  27.    General Information
  28.  
  29. AUTOCHOP operates in two basic  modes:   splitting and rebuilding.   In the
  30. splitting mode,  the "original file" is  broken  into  a  set  of  "segment
  31. files",   while  in  the  rebuild  mode,  the segment files are combined to
  32. recover the original file.   The  segment  files can be identified by their
  33. files extension,  which has the format "#nn",  where "nn"  is  a  two-digit
  34. decimal number ranging from 00 through 99.  Hence, an original files can be
  35. broken  up into as many as one hundred segment files,  which should be more
  36. than adequate.   Unless told  otherwise,   the  segment files have the same
  37. basic filename as the original,  and are created in the same  directory  as
  38. the original.  The filename extension of the original is retained in one of
  39. the  segment  files,   and will be used as the default when the original is
  40. rebuilt.
  41.  
  42. The rebuild process differ slightly  from the splitting operation,  in that
  43. the default directory for the  rebuilt  original  is  the  current  default
  44. directory,   rather  than  the  directory  for the segment files.   This is
  45. logical,  since the segment files are usually on floppies, and you normally
  46. wouldn't want to rebuild the original there.  In any case, the defaults can
  47. always be overridden by command-line parameters.
  48.  
  49. Each segment file begins with a header structure, which is used to identify
  50. the file as being a segment  file  for AUTOCHOP.   When an original file is
  51. split,  a number is chosen at pseudo-random (actually,  from  the  system's
  52. real  time  clock) to serve as the "job ID".   This job ID is placed in the
  53. header of every segment file created during this split.   When the original
  54. is rebuilt,  all the segment files are  checked to insure they all have the
  55. same job ID;  this lessens the chance of including a segment  file  from  a
  56. different  split  operation during a rebuild,  and thus creating an invalid
  57. original.   As an additional safety check, the CRC32 of the entire original
  58. is computed during splitting  and  included  in  one  of the segment files.
  59. During rebuild,  this CRC is  re-computed  from  the  segment  files,   and
  60. compared  the the value stored during the split.   It is very unlikely that
  61. two different files will compute out the same CRC32,  so this check results
  62. in a high degree of confidence that  the rebuild generated the same file as
  63. the original.
  64.  
  65. During splitting,  AUTOCHOP will,  by default,  try to  build  the  largest
  66. segment  files that will fit on the target media.   So,  if the target is a
  67. floppy drive,  the default action is to use all the free space on that disk
  68. for the segment file.   You can,   however,  specify a maximum size for the
  69. segment files;  if you do so,  no segment file will  be  larger  than  this
  70. specification.    You can also specify the minimum size for a segment file;
  71. if there is not enough room on  the  target  media for a file of this size,
  72. you will be so informed.
  73.  
  74. Finally,  there is a "check" option.   This  tells  AUTOCHOP  to  read  the
  75. segment  files,  but no to rebuild the original.   In reading the segments,
  76. the CRC32 is computed, and compared to the value obtained during the split.
  77. This allows you to insure  that  the  segments on floppies are valid before
  78. deleting the original from hard disk.
  79.  
  80.    Splitting Originals
  81.  
  82. The command line to split an original is:
  83.  
  84. AUTOCHOP [min=nnn] [max=nnn] [-p] [drive/path]filename.ext [targname]
  85.  
  86. where items in brackets are optional.   "min" and  "max"  can  be  used  to
  87. specify the minimum and maximum size of the segment files,  they default to
  88. 512 and infinite,  respectively.   Normally,  AUTOCHOP tells you when it is
  89. about to access a segment file, and asks you to kit a key to continue; this
  90. gives  you  the opportunity to change floppies.   By using the "-p" option,
  91. this prompting is dispensed with (this should only be done when writing the
  92. segment files to  a  hard  disk).    The  full  name  of the original file,
  93. including extension,  must be specified.   If the original has no  filename
  94. extension, you must "fake" one by the use of a lone period:
  95.  
  96. MYFILE.
  97.  
  98. since  AUTOCHOP  uses  the  presence  or absence of a filename extension to
  99. determine whether to split or rebuild.   If you want the segment files have
  100. a different basic filename,  and/or be placed in a different directory, you
  101. can do so by making an appropriate file specification after the name of the
  102. original file.   Any extension on  this  second  specification  is  quietly
  103. ignored,   since  AUTOCHOP  creates  its  own  series of extensions for the
  104. segment files.
  105.  
  106. Some examples:
  107.  
  108. AUTOCHOP max=1000000 -p c:\work\myfile.zip
  109.  
  110. creates the set of segment files "myfile,#00",  "myfile.#01", etc.   in the
  111. same directory as the original (ie.,  in C:\WORK\).    Each  file  will  be
  112. limited  to  one  megabyte  in  size,  and you will NOT be prompted as each
  113. segment file is created (the "-p" option).
  114.  
  115. AUTOCHOP max=1000000 -p c:\work\myfile.zip d:\janice\
  116.  
  117. works the same as the first  example,   except the segment files will go in
  118. the directory "D:\JANICE\".
  119.  
  120. AUTOCHOP max=1000000 -p c:\work\myfile.zip mypieces
  121.  
  122. will split the original  into  segments  having  the  name  "mypieces.#00",
  123. "mypieces.#01", etc., in the CURRENT DEFAULT directory.
  124.  
  125. AUTOCHOP c:\work\myfile.zip a:
  126.  
  127. This is probably the most common format for  AUTOCHOP.    This  splits  the
  128. original  file  onto  floppies,   filling each floppy to its available free
  129. space.   You are prompted before each  segment file is created,  giving you
  130. the chance to switch floppies as each fills.
  131.  
  132.    Rebuilding From Segments
  133.    
  134. The command line for this operation is:
  135.  
  136. AUTOCHOP [-p] [drive/path]filename [targname]
  137.  
  138. Note  that  the  first  filespec has NO EXTENSION;  this is the key telling
  139. AUTOCHOP to rebuild,  rather than split.    If no "targname" is given,  the
  140. name of the rebuilt file is the same as that of the segment files, with the
  141. file   extension  of  the  original  restored.    Otherwise,   this  second
  142. specification is used as given for the  output  file (so it must be a valid
  143. filespec).
  144.  
  145. Finally, to check the segment files, use:
  146.  
  147. AUTOCHOP [-p] -c [drive/path]filename
  148.  
  149. again, with no file extension.
  150.  
  151.    Contacting the Author
  152.    
  153. The best way to contact the me is to leave me E-mail on  the  North  Orange
  154. County Computer Club BBS, 714-730-5739, USR 14.4K DS.   Please use the TECH
  155. conference  for  this purpose.   Any future updates to this program will be
  156. posted on this BBS first.
  157.  
  158. Otherwise, you can write to me at:
  159.  
  160. Randy Langer
  161. MircoSphere Technology, Inc.
  162. Box 620
  163. Magalia, CA 95954-0620
  164.  
  165.